- 14.6. Local de Retirada
14.6.2. local de retirada NT201805 [09/03/19] - 14.6.1. local de retirada 2G
« Anterior - 14.7. Local de Entrega
Próximo »
14.6.2. local de retirada NT201805 [09/03/19]
Funcionalidade para gerar o XML do grupo de informações do local de retirada
Assinatura
string localRetiradaNT201805(string CNPJ, string CPF, string xNome_Opc, string xLgr, string nro, string xCpl_Opc, string xBairro, string cMun, string xMun, string UF, string CEP_Opc, string cPais_Opc, string xPais_Opc, string fone_Opc, string email_Opc, string IE_Opc)
Descrição:
Funcionalidade para gerar o XML do grupo de informações do local de retirada da versão 4.00 do leiaute da NF-e.
Dica
Este grupo de informação só deve ser informado nos casos em que o local de retirada seja diferente do endereço do remetente, cabendo ressaltar que é necessário que a situação esteja prevista na legislação, como é o caso da obra de construção civil.
Parâmetros:
| nome | tipo | tam. | obrig. | descrição |
|---|---|---|---|---|
| CNPJ | string | 14 | sim | informar o CNPJ, sem formatação ou máscara |
| CPF | string | 11 | sim | informar o CPF, sem formatação ou máscara |
| xNome_Opc | string | 2-60 | não | informar o Razão Social ou Nome do Recebedor (campo novo) |
| xLgr | string | 2-60 | sim | informar o logradouro do local de retirada |
| nro | string | 1-60 | sim | informar o número do endereço do local de retirada, campo obrigatório. Informar S/N ou . (ponto) ou - (traço) para evitar falha de schema XML quando não houver número. |
| xCpl | string | 1-60 | não | informar o complemento do endereço do local de retirada, pode ser omitido |
| xBairro | string | 2-60 | sim | informar o bairro do endereço do local de retirada |
| cMun | string | 7 | sim | informar o código do município na codificação do IBGE com 7 dígitos |
| xMun | string | 2-60 | sim | informar o nome do município |
| UF | string | 2 | sim | informar a sigla da UF |
| CEP_Opc | string | 8 | não | informar Código do CEP com os zeros não significativos. (campo novo) |
| cPais_Opc | string | 4 | não | informar o Código do País. Utilizar a Tabela do BACEN (Anexo IX - Tabela de UF, Município e País). (campo novo) |
| xPais_Opc | string | 2-60 | não | informar o Nome do País (campo novo) |
| fone_Opc | string | 6-14 | não | informar o Telefone Preencher com o Código DDD + número do telefone. Nas operações com exterior é permitido informar o código do país + código da localidade + número do telefone (campo novo) |
| email_Opc | string | 1-60 | não | informar o Endereço de e-mail do Recebedor (campo novo) |
| IE_Opc | string | 2-14 | não | informar Inscrição Estadual do Estabelecimento Recebedor Informar somente os algarismos, sem os caracteres de formatação (ponto, barra, hífen, etc.). (campo novo) |
Diagrama:
Dica
Os campos com contorno tracejado podem ser omitidos se a operação não exigir a informação.
Retorno:
Um string com o grupo XML do Local de Retirada
XML:
Exemplo de XML compatível com a versão anterior do grupo retirada
<retirada> <CPF>00000000191</CPF> <xLgr>Rua Libero Badaro</xLgr> <nro>280</nro> <xCpl>10 andar</xCpl> <xBairro>CENTRO</xBairro> <cMun>3550308</cMun> <xMun>SAO PAULO</xMun> <UF>SP</UF> </retirada>
Exemplo de XML da versão completa do grupo retirada
<retirada> <CPF>00000000191</CPF> <xNome>Fulano de Tal</xNome> <xLgr>Rua Libero Badaro</xLgr> <nro>280</nro> <xCpl>10 andar</xCpl> <xBairro>CENTRO</xBairro> <cMun>3550308</cMun> <xMun>SAO PAULO</xMun> <UF>SP</UF> <CEP>01100100</CEP> <cPais>105</cPais> <xPais>Brasil</xPais> <fone>11332001234</fone> <email>fulano@tal.com.br</email> </retirada>
Importante
O trecho do XML foi formatado para uma melhor visualização, a mensagem original não tem formatação.
Vale observar que a formatação pode corromper a assinatura digital, além de ocupar espaço e ser desnecessária, pois os browser exibem formatado.
Exemplos de uso:
Visual Basic 6.0
' inicializar variáveis '............................................... Dim objNFeUtil As Object Set objNFeUtil = CreateObject("NFe_Util_2G.Util") ' '========grupo de informações do local de Retirada(grupo F do Manual de Integração)========= ' ' <>&" são caracteres reservados do XML e devem ser evitados ou substituídos ' por < &gy; & " ' ' Vale ressaltar que as aplicações das UF devem mostrar DIAS & DIAS TENTANDO S/A, ' pois não entedem & como &, assim talvez seja melhor substituir o & por e. ' locRet_CNPJ = "" ' CNPJ sem máscara de formatação locRet_CPF = "00000000191" ' CPF sem máscara de formatação locRet_xNome = "" ' Nome expedidor locRet_xLgr = "Rua Libero Badaro" ' logradouro locRet_nro = "280" ' número, informar S/N quando inexistente para evitar erro de Schema XML locRet_xCpl = "10 andar" ' complemento do endereço, o conteúdo pode ser omitido locRet_xBairro = "CENTRO" ' bairro locRet_cMun = "3550308" ' código do município, deve ser compatível com a UF locRet_xMun = "SAO PAULO" ' nome do município locRet_UF = "SP" ' sigla da UF locRet_CEP = "" ' CEP locRet_cPais = "" ' código do país locRet_xPais = "" ' nome do país locRet_fone = "" ' telefone DDNNNNNNNNN locRet_email = "" ' e-mail locRet_IE = "" ' Inscrição Estadual ' ' gera grupo do local de Retirada ' locRetirada = objNFeUtil.localRetiradaNT201805(locRet_CNPJ, locRet_CPF, locRet_xNome, locRet_xLgr, locRet_nro, locRet_xCpl, locRet_xBairro, locRet_cMun, locRet_xMun, locRet_UF, locRet_CEP, locRet_cPais, locRet_xPais, locRet_fone, locRet_email, locRet_IE) MsgBox "local de retirada: " + locRetirada, vbInformation, "Resultado"
Exemplo de geração do XML completo do grupo retirada
' inicializar variáveis '............................................... Dim objNFeUtil As Object Set objNFeUtil = CreateObject("NFe_Util_2G.Util") ' '========grupo de informações do local de Retirada(grupo F do Manual de Integração)========= ' ' <>&" são caracteres reservados do XML e devem ser evitados ou substituídos ' por < &gy; & " ' ' Vale ressaltar que as aplicações das UF devem mostrar DIAS & DIAS TENTANDO S/A, ' pois não entedem & como &, assim talvez seja melhor substituir o & por e. ' locRet_CNPJ = "" ' CNPJ sem máscara de formatação locRet_CPF = "00000000191" ' CPF sem máscara de formatação locRet_xNome = "Fulano de Tal" ' Nome expedidor locRet_xLgr = "Rua Libero Badaro" ' logradouro locRet_nro = "280" ' número, informar S/N quando inexistente para evitar erro de Schema XML locRet_xCpl = "10 andar" ' complemento do endereço, o conteúdo pode ser omitido locRet_xBairro = "CENTRO" ' bairro locRet_cMun = "3550308" ' código do município, deve ser compatível com a UF locRet_xMun = "SAO PAULO" ' nome do município locRet_UF = "SP" ' sigla da UF locRet_CEP = "011001001" ' CEP locRet_cPais = "1058" ' código do país locRet_xPais = "Brasil" ' nome do país locRet_fone = "11332001234" ' telefone DDNNNNNNNNN locRet_email = "fulano@tal.com.br" ' e-mail locRet_IE = "" ' Inscrição Estadual ' ' gera grupo do local de Retirada ' locRetirada = objNFeUtil.localRetiradaNT201805(locRet_CNPJ, locRet_CPF, locRet_xNome, locRet_xLgr, locRet_nro, locRet_xCpl, locRet_xBairro, locRet_cMun, locRet_xMun, locRet_UF, locRet_CEP, locRet_cPais, locRet_xPais, locRet_fone, locRet_email, locRet_IE) MsgBox "local de retirada: " + locRetirada, vbInformation, "Resultado"
- 14.6.2. local de retirada NT201805 [09/03/19]
14.6. Local de Retirada - « Anterior
14.6.1. local de retirada 2G - Próximo »
14.7. Local de Entrega